home *** CD-ROM | disk | FTP | other *** search
/ Shareware Overload Trio 2 / Shareware Overload Trio Volume 2 (Chestnut CD-ROM).ISO / dir31 / volume.zip / VOLUME.TXT < prev    next >
Text File  |  1993-10-21  |  8KB  |  136 lines
  1. DESCRIPTION:
  2.  
  3. VOLUME.COM is a TSR that turns a joystick into a volume/balance control for
  4. your ProAudio Spectrum sound card.  This program works in DOS and Windows
  5. (you must run it from DOS prior to entering Windows, though.)  It checks the
  6. joystick every 1/2 second, and updates the output volume level if the joystick
  7. has changed postion.  
  8.  
  9. Forward/back controls the volume and left/right controls the balance.  While
  10. button #1 is held down, updates are inhibited.  (This is useful for connecting
  11. a disable/enable switch for reasons mentioned in the PROBLEM section, below.)
  12. When button #2 is pressed (for more than 1/2 second), update inhibit is toggled.
  13. This is useful for disabling updates for reasons mentioned below, or for 
  14. freezing the current setting (useful for people with auto-centering joysticks,
  15. or joysticks that will not hold in one position.)
  16.  
  17. If a number is specified on the command line, this number (default=512) is used
  18. as the joystick timing parameter.
  19.  
  20. VOLUME2.COM is the same as VOLUME.COM, except it is set up to operate with the
  21. second joystick.  Using this routine will allow you to use the first joystick
  22. in your games and still have control over the volume using the second 
  23. joystick (or the home-made volume control box mentioned below).
  24.  
  25. COMMAND LINE PARAMETERS:
  26.  
  27. To run the program, enter the command "VOLUME" from the DOS prompt.
  28. To uninstall the program, enter the command "VOLUME U" from the DOS prompt.
  29.  
  30. The program also takes an (optional) parameter that specifies the maximum
  31. count that the joystick will reach.  This value defaults to 512 (which works
  32. on my 486DX/33 with a ProAudio Studio 16 sound card.)  Slower computers will
  33. need smaller numbers.  The number will also vary with the size of the
  34. potentiometers in the joystick and the size of capacitors on the joystick
  35. port.  Too small of a number will cause the full volume swing to occur over
  36. a short piece of the joystick's full travel.  Too large of a number will
  37. prevent the volume from fully reaching zero.  To specify this parameter,
  38. enter the command "VOLUME 300", where 300 should be replaced with the number
  39. that works for you.
  40.  
  41. HINTS:
  42.  
  43. Note that once the program is installed, you must first uninstall it
  44. (VOLUME U) before restarting it with a new parameter.
  45.  
  46. The program works best if you have a joystick that does not have auto-center
  47. (or the ability to turn auto-centering off) and center adjustment knobs.  The
  48. joystick should also be stiff enough to hold it's position when you let go.
  49. I have my left-right motion on auto center, and use the center adjustment knob
  50. for this direction as my balance control.  I leave the forward-backward motion
  51. floating so that the stick gives volume control.
  52.  
  53. You can see the volume and balance change on the screen if you use the PAS
  54. mixer program provided with your sound card (run "PAS *" from the DOS command
  55. line).  This is useful for checking to see if the full range of motion is
  56. being reached.  Unfortunately the DOS mixer routines do not interact with
  57. the Windows mixer routines, so the changes made by the joystick do not show
  58. up in the Windows mixer programs (such as Pocket Mixer).
  59.  
  60. If you do not have a joystick, or want to have an external volume control
  61. in addition to your current joystick (so that the joystick may be used in 
  62. games), you can go down to your local electronics store and make your own
  63. external mixer.  All you need are two potentiometers (both the same value,
  64. between 100k and 1M ohms, bigger for slower computers), a box to mount them in, 
  65. and a connector to the joystick port (male DB-15).  The X pot wiper (generally 
  66. the center terminal) should be connected to pin 11, and one end (the end 
  67. selected determines which direction gives left balance) connected to pin 9.  
  68. The Y pot wiper should be connected to pin 13, and one end (the end selected 
  69. determines which direction gives zero volume) connected to pin 9.  You may also
  70. include a disable switch by connecting a switch between button 1 (pin 10) and 
  71. ground, or a momentary pushbutton between button 2 (pin 14) and ground (pin 4 
  72. or 5).  This disable switch is useful for the reason mentioned in the following
  73. section.
  74.  
  75. PROBLEMS:
  76.  
  77. Since the routine performs a joystick timing loop during an interrupt routine,
  78. interrupts are disabled for a relatively long time every 1/2 second.  While
  79. this is fine under most circumstances, it can cause dropped characters for 
  80. high speed modems (or other serial port devices).  For this reason, the
  81. capability to inhibit updates by pressing a button was included.  If you
  82. have problems with serial port communications, you should disable the volume
  83. updates during serial communications.
  84.  
  85. MESSAGES RETURNED BY THE PROGRAM:
  86.  
  87. Joystick volume control has been installed.
  88.    This message simply informs you that all is well with the installation.
  89.  
  90. Joystick volume control has been removed from memory.
  91.    This message simply informs you that all went well with the un-install
  92.    procedure.
  93.  
  94. ERROR: Joystick volume control not installed because MV driver not present.
  95.    This message is returned if you attempt to install the program, but it is
  96.    unable to link into the Media Vision mixer routines.  Check to see that
  97.    the MVSOUND.SYS driver is installed in your CONFIG.SYS file, and that it
  98.    remains in memory (if the u parameter is used with the MVSOUND program,
  99.    it just initializes the card, but does not remain in memory.) 
  100.  
  101. ERROR: Cannot remove volume control because the interrupt vector has changed.
  102.    This message is returned if some other program (the DOS print command, for
  103.    example) has installed itself in the same interrupt vector.  These programs
  104.    must be un-installed in the reverse order in which they were installed.
  105.    This message is also returned if you try to uninstall VOLUME when it is 
  106.    not currently loaded.
  107.  
  108. ERROR: Joystick volume control is already installed!
  109.    This message is returned if you re-run the VOLUME program when a copy is
  110.    already running of the system.  If you want to change the joystick count
  111.    parameter or switch from joystick 1 to joystick 2, uninstall the program
  112.    first, and then re-install with the new parameter.
  113.  
  114. OTHER INFORMATION:
  115.  
  116. This program has not been tested very extensively, and is the very first 
  117. edition.  While it should not affect the operation or stability of your system,
  118. you use this program at your own risk.  ABSOLUTELY NO WARRANTIES ARE GIVEN
  119. OR IMPLIED, AND THE AUTHOR IS NOT RESPONSIBLE FOR ANY PROBLEMS, MACHINE CRASHES,
  120. OR DATA LOSS THAT MIGHT RESULT FROM THE USE OF THIS PROGRAM.  However, if you 
  121. do run across any problems or incompatabilies with specific programs, please 
  122. drop me a line so that I can fix the problem or at least make a note of the 
  123. incompatability in future releases.  I can be reached at:
  124.  
  125. Philip VanBaren                         71214,2302 on Compuserve
  126. 1845 Lake Lila Dr. Apt. C3              phillipv@engin.umich.edu on Internet
  127. Ann Arbor, MI  48105
  128.  
  129. I have also been considering making an external mixer box with 8 or 16 slide
  130. controls that could be connected to the joystick port.  With this type of box
  131. you would have control over most of the mixer channels (either just volume,
  132. or possibly left/right volume or volume/balance.)  The box could also have
  133. connectors for joystick 1 and MIDI in/out.  If you would be interested in 
  134. such a box, let me know.  The more interest there is, the faster I will work
  135. on this project...
  136.